home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / xzt10mc.zip / EXZTEST.TXT < prev    next >
Text File  |  1993-04-01  |  50KB  |  1,006 lines
  1.  
  2.  
  3.                                 <=  ExZTest  =>
  4.  
  5.                                   Version 2.23
  6.  
  7.                 Part of the EXpert series programs available at
  8.  
  9.                    The Executive Network Information System
  10.                                 (914) 667-4567
  11.  
  12.                   ------------------------------------------
  13.  
  14.                       Copyright 1988-1991 by Andy Keeves
  15.            Licensed modifications Copyright 1992 by Michael W. Cocke
  16.  
  17.       ===================================================================
  18.  
  19.       ExzTest has been licensed to, and is now distributed and supported
  20.       by MWC Enterprises.  This is the original documentation (with some
  21.       editing).  A number of things aren't covered in a whole lot of 
  22.       detail.  The reason is simple;  This is simply an interim release.
  23.       Xtest 1.0 should be in alpha test by April 1993.  In the meantime,
  24.       ExzTest is Freeware from MWC Enterprises.
  25.  
  26.       The formerly offered interface to FWKCS no longer works due to
  27.       changes in that product. If you have duplicate checking turned on
  28.       and select FWKCS, I guarantee it won't work right.
  29.       
  30.       ExzTest will correctly run ZDCS.  ExzSetup will still allow you 
  31.       to select FWKCS.  Do NOT attempt to select it - ExzTest will 
  32.       merrily go on it's way and something will crash.
  33.  
  34.       ===================================================================
  35.  
  36. Welcome to ExZTest!
  37. ──────────────────────────────────────────────────────────────────────────────
  38.  
  39.         ExZTest once once envisioned as a small program to help remove some of
  40. the "extra" stuff from displays generated by PKZIP during new upload testing.
  41. Of course, in those days, sophisticated BAT files were needed and the
  42. PCBTEST.BAT file was brand new for PCBoard systems.
  43.  
  44.         ExZTest simmplifies the testing of newly uploaded files to a BBS and
  45. takes care of most of the associated chores based on a configuration file. If
  46. you have used previous versions of this program MAKE SURE you read through
  47. these notes as LOTS of things have changed!
  48.  
  49.         In short, ExZTest has the ability to test newly uploaded files for
  50. integrity (if they have been compressed with PKZIP or PKARC), check for
  51. possible virus infections through the use of external programs of your choice,
  52. check for possible file duplication regardless of name, remove unwanted files
  53. and many other like fuctions.
  54.  
  55.         ExZTest is geared toward PCBoard BBS systems although it is possible
  56. to use it with any BBS which allows a shell after a new upload.
  57.  
  58.  
  59.  
  60. If you have used ExZTest before..   READ THIS!
  61. ──────────────────────────────────────────────────────────────────────────────
  62.  
  63.         ExZTest version 2.0 introduces a full-featured setup program and a
  64. totally new configuration file format!  The command line options used by older
  65. versions is NOT COMPATIBLE WITH 2.x VERSIONS!  Do not attempt to an old
  66. PCBTEST.BAT file with this program without configuring first!!  At the least,
  67. the results shall be undesirable!
  68.  
  69.         The ExZTest 2.0 configuration file was designed with upward
  70. compatibility in mind.  ExZip and ExZSetup will automatically recognize file
  71. formats starting with this version and handle any required upgrading for you.
  72.  
  73.         You can share a single configuration file between ExZip and ExZTest if
  74. so desired.  After all, most of the parameters are the same or similar.
  75.  
  76.  
  77.  
  78. Distribution and License!!   Please read this!
  79. ──────────────────────────────────────────────────────────────────────────────
  80.  
  81. ExZTest is now Freeware from MWC Enterprises.  A number of improvements and
  82. new features are planned for Xtest, but that's going to take some time.
  83.  
  84. This program is released subject to the following conditions:
  85.  
  86.      a)   You do not charge for it.  No fees of any sort are
  87.           authorized to be asked for, accepted or collected!
  88.      b)   Any and all alterations to the program or
  89.           documentation are expressly prohibited!  You may,
  90.           however, post the program on your system in the format
  91.           you prefer (i.e. .ZIP or .ARC or whatnot).
  92.      c)   You may not add any files to the ZIP file or other
  93.           compressed distribution file you may be using,
  94.           including your own bbs ad, and similarly, you may not
  95.           remove any file from the content.
  96.  
  97.         I must also add here that there are no warranties of any sort,
  98. expressed or implied, that accompany this program.   Use at your own risk.
  99.  
  100.         Sorry.  If you feel that the above points are not agreeable to you,
  101. simply delete the file from your system.  Pretty easy, don't you think?
  102. Should you feel that you absolutely must pay for ExZTest, send a few $$ to
  103. your favorite BBS Sysop - believe me, all Sysops can use it, since running
  104. a board is NOT cheap!  Please remember that I will try to fix problems as
  105. reported, but I will do so at my convenience as time is available.  This
  106. program is made available to you at no cost or investment which should
  107. be considered when requesting "support".
  108.  
  109.  
  110.  
  111. Features summary.
  112. ──────────────────────────────────────────────────────────────────────────────
  113.  
  114.         ExZTest is controlled through a configuration file.  The supplied
  115. ExZSetup program MUST be used for setting it up!  DO NOT try to edit the
  116. configuration file with a text editor!  It will NOT work!
  117.  
  118.  
  119. General features:
  120.  
  121.      o    Interfaces with STRIPZIP to remove file attributes;
  122.      o    Handles primary and secondary ZIPs, ARCs, PAKs as
  123.           well as self-extracting ZIPs;
  124.      o    Abbreviated activity and error logs;
  125.      o    Checking for viruses and associated file disposition;
  126.      o    Optional use of up to 5 different virus checking
  127.           programs;
  128.      o    Optional use of duplicate checking and related disposition;
  129.      o    Full featured setup program;
  130.      o    Fully networkable operation;
  131.      o    Unwanted file removal from ZIPs (TCAN);
  132.      o    Automatic removal of ZIP comments;
  133.      o    Alternate ZIP and ARC programs;
  134.      o    Your choice of ZIP options for compression;
  135.      o    Read Only and Hidden file handling;
  136.      o    Adding a standard ZIP comment;
  137.      o    Full self-check and anti-virus protection;
  138.      o    File Id stamping to recognize files already processed,
  139.           even if they would normally qualify for ExZip's use;
  140.      o    Creates PCBoard compatible pass/fail result files;
  141.      o    Uses standard PCBoard 14.5 color codes;
  142.      o    Optionally word-wraps file description;
  143.      o    Optionally adds latest date in archive to description;
  144.      o    Damaged file disposition options and matching notation
  145.           for PCBoard sysops;
  146.      o    Enhanced file creation/write routines written in
  147.           assembler for added speed;
  148.      o    Full error checking and handling, including full
  149.           network compatibility;
  150.      o    Full duplicate checking through ZDCS (Copyright 1991-1992,
  151.           MWC Enterprises)
  152.  
  153. New in version 2.1:
  154.  
  155.      o    Recognizes subdirectories stored in archives and will
  156.           "fail" files which contain them, holding them for review
  157.           by sysop.
  158.      o    Additional DOS errorlevels are now supported:
  159.                 Errorlevel 3 - if target file is a GIF
  160.                 Errorlevel 4 - if target file is unknown
  161.  
  162.  
  163.  
  164.  
  165. The use of external programs
  166. ──────────────────────────────────────────────────────────────────────────────
  167.  
  168.         ExZTest now incorporates the use of some programs written by
  169. other authors.  One of these programs is STRIPZIP, written by
  170. Ken Brown, made available to everyone free, as POSTWare.  If you
  171. use it, DO send him a postcard to THANK him for a terrific job!
  172. StripZip should be available on most BBSs.  
  173.  
  174.         The second of these is VIRUSCAN from McAfee Associates.
  175. Please note that ViruScan is NOT a free program!  As with all ShareWare,
  176. please register it if you are going to use it!  This program can be
  177. found on most BBSs listed as SCANxxxx.ZIP, including the Executive
  178. Network, of course.  Although we have received permission from McAfee
  179. Associates to include SCAN with the ExZTest distribution file, we elected
  180. not to do so (with the exception of one release) due to the frequency
  181. of upgrades for this product.
  182.  
  183.         For duplicate checking introduced in version 2.0 ExZTest interfaces
  184. with ZDCS from Michael Cocke.  
  185.  
  186. Please note that these programs are Shareware, and if you elect to use 
  187. them you really SHOULD register them. 
  188.  
  189.  
  190.  
  191. Getting started and setting up
  192. ──────────────────────────────────────────────────────────────────────────────
  193.  
  194.         ExzSetup will do most of the work for you initially.  Remember that
  195. this manual is not intended to teach about the use of PCBoard or other
  196. programs with which ExZTest might interface. You must have a working knowledge
  197. of these before you get started here!
  198.  
  199.         ExZSetup can be executed by simply typing "EXZSETUP" at the DOS prompt
  200. or by specifying the drive, path and name of the configuration file you wish
  201. to create or edit.  For the rest of this document we will assume that you are
  202. using the name EXZTEST.CFG which will be located in the current path.  Once
  203. you typed EXZSETUP you will get a small selection menu as follows:
  204.  
  205.  
  206.                         ┌─────────────────────────────┐
  207.                         │ ExZip run time parameters   │
  208.                         │ ExZTest run time parameters │
  209.                         │ ─────────────────────────── │
  210.                         │ Define external text editor │
  211.                         │ ─────────────────────────── │
  212.                         │ Quit ExZSetup               │
  213.                         └─────────────────────────────┘
  214.  
  215.  
  216. Press the DownArrow followed by ENTER to create/edit the EXZTEST.CFG
  217. configuration file. The bottom line of your screen will be a status line
  218. with brief instructions for you:
  219.  
  220.  
  221.  04:54:45 pm │ Esc: Exit/Backup │ Space: Toggle │ Cursor keys: Move │ CAP
  222.  
  223.  
  224. The right side of the line will reflect the status of your Caps Lock and Num
  225. Lock keys while the left side will reflect the then current system time. The
  226. middle portion will indicate the usage of various control keys.  If your
  227. configuration file does not exist you will be asked if you want to create it:
  228.  
  229.  
  230.  
  231.  ┌[ File access error ]─────────────────────────────────────────────┐
  232.  │ Problem:  File not found or invalid!                             │
  233.  │ Target :  EXZTEST.CFG                                            │
  234.  │ Action :  Create new file now (Y/N)?  _                          │
  235.  └──────────────────────────────────────────────────────────────────┘
  236.  
  237. Press "Y" to confirm and proceed.  You are now displayed the main options menu
  238. which are applicable to the operation of EXZTEST.
  239.  
  240.  
  241.         ┌─────────────────────────────┐
  242.         │ ExZip run time parameters   │
  243.         │ ExZTest run time parameters │
  244.         │ ────────╒══════════════════════════════════╕
  245.         │ Define e│ Virus checking                   │
  246.         │ ────────│ Duplicate checking               │
  247.         │ Quit ExZ│ File attribute handling          │
  248.         └─────────│ ──────────────────────────────── │
  249.                   │ Disposition of damaged files     │
  250.                   │ Disposition of virus infections  │
  251.                   │ ──────────────────────────────── │
  252.                   │ ZIP comment insertion            │
  253.                   │ Compression programs             │
  254.                   │ Compression formats to process   │
  255.                   │ Run time options (switches)      │
  256.                   │ Activity log file                │
  257.                   │ ──────────────────────────────── │
  258.                   │ Supporting files (text)          │
  259.                   │ Supporting files (processing)    │
  260.                   ╘══════════════════════════════════╛
  261.  
  262.  
  263. You can move around the menu with your up and down arrow keys, page up and
  264. page down and you may leave the menu by pressing the escape key. Once you have
  265. positioned yourself to the item you wish to edit simply press the ENTER key to
  266. proceed.  Most menus and options that follow will require the use of the
  267. cursor control keys though a few will also require typing.  We will take each
  268. selection as they appear on the menu above (this is not my favorite part when
  269. it comes to releases!).
  270.  
  271.  
  272.  
  273. Checkin for virus infection
  274. ──────────────────────────────────────────────────────────────────────────────
  275.  
  276.         You can have ExZTest use up to 5 different programs to check for virus
  277. infections.  They must all have the ability to take all required parameters
  278. from the DOS command line and operate on all files in a specified path (passed
  279. to them by ExZTest).  ExZSetup will give you the default command line for
  280. McAffe's Viruscan program.  Use the "!" character where the location of files
  281. to be checked should go:
  282.  
  283.  
  284. ┌─────────────────────────────┐
  285. │ ExZip run time parameters   │
  286. │ ExZTest run time parameters │
  287. │ ────────╒══════════════════════════════════╕
  288. │ Define e│ Virus checking                   │
  289. │ ────────│ Du┌[ Virus detection ]───────────────────────────────────────┐
  290. │ Quit ExZ│ Fi│                                                          │
  291. └─────────│ ──│ Virus checking: ON                                       │
  292.           │ Di│      Program 1: SCAN ! /NOMEM /A /X /EXT Z:NUV           │
  293.           │ Di│      Program 2:                                          │
  294.           │ ──│      Program 3:                                          │
  295.           │ ZI│      Program 4:                                          │
  296.           │ Co│      Program 5:                                          │
  297.           │ Co│                 ┌─────────────────────────────────┐      │
  298.           │ Ru└─────────────────│    Space or Enter to toggle     │──────┘
  299.           │ Activity log file   │   Arrow keys to change lines    │
  300.           │ ────────────────────│          ESC to exit            │
  301.           │ Supporting files (te└─────────────────────────────────┘
  302.           │ Supporting files (processing)    │
  303.           ╘══════════════════════════════════╛
  304.  
  305.  
  306.  
  307. Checking for and eliminating duplicates
  308. ──────────────────────────────────────────────────────────────────────────────
  309.  
  310.         This one becomes more complex!  ExZTest relies on ZDCS
  311. to establish file duplications.  You need to have completed the setup of
  312. ZDCS in order to use the duplicate checking options of ExZTest.
  313.  
  314. Please consult the documentation for your choice of programs BEFORE deciding
  315. here.  
  316.  
  317.         NOTE!!  If you decide to use ZDCS as the duplicate checking engine
  318.                 for ExZTest you need to know that this version of ExZTest 
  319.                 will work ONLY with the 2.0 or later releases of this 
  320.                 software!!  Earlier versions did not offer the hooks 
  321.                 used by ExZTest!
  322.  
  323.         If you toggle duplicate checking ON you will have to define a few
  324. other choices for ExZTest!  Before setting up and testing ExZTest for 
  325. duplicate detection you should have set up ZDCS.  In order to give you a 
  326. better understanding of these we need to define what the definitions shown 
  327. below mean.
  328.  
  329.         A "full, 100% duplicate" is a .ZIP file the contents of which already
  330. exists on your system.  The content may be in another single .ZIP or spread
  331. over several .ZIPs - we simply do not care.  If every file is already present
  332. somewhere we will consider it a FULL duplicate.  You may dispose of these
  333. files by deleting them or renaming them.  If you elect to rename ExZTest will
  334. change the file's extention to .DUP for you.  You may toggle this choice by
  335. pressing the space bar once highlighted.
  336.  
  337.         If you selected ZDCS your screen will look something like:
  338.  
  339.  
  340. ┌─────────────────────────────┐
  341. │ ExZip run time parameters   │
  342. │ ExZTest run time parameters │
  343. │ ────────╒══════════════════════════════════╕
  344. │ Define e│ Virus checking                   │
  345. │ ────────│ Dup┌[ Duplicate checking ]───────────────────────────────┐
  346. │ Quit ExZ│ Fil│                                                     │
  347. └─────────│ ───│ Duplicate checking                     : ON         │
  348.           │ Dis│ Software in use (ZDCS)           : ZDCS             │
  349.           │ Dis│                                                     │
  350.           │ ───│   Disposition of full (100%) duplicates: D (Delete) │
  351.           │ ZIP│   Disposition of partial duplicates    : A (Auto!)  │
  352.           │ Com│   Minimum percentage to pass partial   : 18%        │
  353.           │ Com│                                                     │
  354.           │ Run│                                                     │
  355.           │ Act│                                                     │
  356.           │ ───│                          ┌─────────────────────────────────┐
  357.           │ Sup│                          │    Space or Enter to toggle     │
  358.           │ Sup│                          │   Arrow keys to change lines    │
  359.           ╘════└──────────────────────────│          ESC to exit            │
  360.                                           └─────────────────────────────────┘
  361.  
  362.  
  363.         You have 3 possible choices for a partial duplicate.  A partially
  364. duplicated .ZIP file is one where at least one of the files within the .ZIP
  365. does not yet exist on your system.  Once again, you can toggle the choices for
  366. partial duplicate disposition by pressing the space bar once the selection is
  367. highlighted.  ExZip will not delete a partial duplication for you.  The most
  368. common partial duplication is a newer version of a file where some of the
  369. documentation has not changed.  You can rename the file and decide later or
  370. you can "pass" the file as is, making it available to your callers.  The 3rd
  371. choice is an automatic decision to be made by ExZTest.  This is based on the
  372. percentage of duplication.  You may specify percentages on the next line
  373. starting with 10%.  The value you specify here is the percentage
  374. of files which are NEW to your system!  Each new upload must contain at 
  375. least this percentage of new files, which do not already exist on your 
  376. system!  In other words, if you were to specify 60% a .ZIP file containing 
  377. 10 files inside would "pass" if 4 or less of the 10 files were duplicates 
  378. and "fail" if 5 or more were duplicated.
  379.  
  380.         NOTE that when using ZDCS this percentage specification need not be
  381. the same as the one entered in your ZDCS configuration file!  The two can and
  382. do operate quite well and independent of each other!  You should also note 
  383. that the usage of percentages by ZDCS is quite different from the above, 
  384. but the translation is done by the programs and transparent to you!
  385.  
  386.  
  387.  
  388. Handling file attributes in ZIPs
  389. ──────────────────────────────────────────────────────────────────────────────
  390.  
  391.         ZIP files have the ability to retain file attributes, such as Read
  392. Only which can do nasty things to your system.  We aim to remove these before
  393. doing anything with the file.  A program widely available on BBSs called
  394. STRIPZIP is the one we default to since it handles the task rather well.
  395. ExZTest will insert the name of the file being processed whereever you type a
  396. pound sign (#) which makes this option reasonably flexible.  DO NOT overlook
  397. or underestimate the power of this option!  Too many Sysops have been burned
  398. by files extracted from a ZIP which could not be deleted and were added to
  399. other ZIPs later in the processing cycle!!
  400.  
  401.  
  402. ┌─────────────────────────────┐
  403. │ ExZip run time parameters   │
  404. │ ExZTest run time parameters │
  405. │ ────────╒══════════════════════════════════╕
  406. │ Define e│ Virus checking                   │
  407. │ ────────│ Duplicate checking               │
  408. │ Quit ExZ│ File attribute handling          │
  409. └─────────│ ──────────────────────────────── │
  410.           │ Dispositi┌[ Attribute handling ]─────┐
  411.           │ Dispositi│                           │
  412.           │ ─────────│ STRIPZIP /R #             │
  413.           │ ZIP comme│          ┌────────────────────────────────────┐
  414.           │ Compressi└──────────│   Enter a single pound sign (#)    │
  415.           │ Compression formats │ where the .ZIP file name should be │
  416.           │ Run time options (sw│  This is a full DOS command line   │
  417.           │ Activity log file   └────────────────────────────────────┘
  418.           │ ──────────────────────────────── │
  419.           │ Supporting files (text)          │
  420.           │ Supporting files (processing)    │
  421.           ╘══════════════════════════════════╛
  422.  
  423.  
  424.  
  425. Disposition of damaged or virus infected files
  426. ──────────────────────────────────────────────────────────────────────────────
  427.  
  428.         Both of these options are defined the very same way.  The pop-up
  429. screen offers you 4 choices through which you can move up and down with your
  430. arrow keys.  Once you highlighted the option you desire to use press ENTER or
  431. ESC to activate it.  Hopefully, the following illustration will be
  432. self-explanatory to most reading this..
  433.  
  434.  ┌─────────────────────────────┐
  435.  │ ExZip run time parameters   │
  436.  │ ExZTest run time parameters │
  437.  │ ────────╒══════════════════════════════════╕
  438.  │ Quit ExZ│ Virus checking                   │
  439.  └─────────│ Duplicate checking               │
  440.            │ File attr╔══════════════════════════════════════╗
  441.            │ ─────────║ Disposition of damaged files:        ║
  442.            │ Dispositi╚════════════════════┌─────────────────────────────┐
  443.            │ Disposition of virus infection│ Keep target file            │
  444.            │ ──────────────────────────────│ Delete target file          │
  445.            │ ZIP comment insertion         │ Overwrite with 0 byte file  │
  446.            │ Compression programs          │ Rename and keep file        │
  447.            │ Process files in .ARC format  └─────────────────────────────┘
  448.            │ Use ANSI colors in DOS           │
  449.            │ Activity log file                │
  450.            │ ──────────────────────────────── │
  451.            │ Paths to process                 │
  452.            │ Supporting files                 │
  453.            │ Index file specifications        │
  454.            ╘══════════════════════════════════╛
  455.  
  456.  
  457.  
  458. ZIP file comments
  459. ──────────────────────────────────────────────────────────────────────────────
  460.  
  461.         While we are very much against BBS ADS being inserted into ZIPs as
  462. files we have no real problems with comments being added to the ZIP file.
  463. Comments are easily removed by anyone (STRIPZIP mentioned above will
  464. automatically remove them for you!).  If you wish to add a ZIP comment of your
  465. own to files processed by ExZTest you need to create a text file containing the
  466. comment to add.  Once you have done this you simply turn on the option in
  467. ExZSetup and specify the exact location and file name which contains the text.
  468.  
  469.  ┌─────────────────────────────┐
  470.  │ ExZip run time parameters   │
  471.  │ ExZTest run time parameters │
  472.  │ ────────╒══════════════════════════════════╕
  473.  │ Quit ExZ│ Virus checking                   │
  474.  └─────────│ Duplicate checking               │
  475.            │ File attribute handling          │
  476.            │ ──────────────────────────────── │
  477.            │ Disposition of damaged files     │
  478.            │ Disposition of virus infections  │
  479.            │ ──────────────────────────────── │
  480.           ┌[ Zip comment insertion ]─────────────────────────────────────┐
  481.           │                                                              │
  482.           │ In use  : NO                                                 │
  483.           │ Filename:                                                    │
  484.           │                                                              │
  485.           └──────────────────────────────────────────────────────────────┘
  486.            │ Paths to process                 │
  487.            │ Supporting files                 │
  488.            │ Index file specifications        │
  489.            ╘══════════════════════════════════╛
  490.  
  491.  
  492.  
  493. Compression programs
  494. ──────────────────────────────────────────────────────────────────────────────
  495.  
  496.         Although ExZTest's primary task is to handle ZIP files it does have
  497. the ability to check .ARC files for you.  It will automatically detect the
  498. file type based on the extension but it will not verify it otherwise.
  499.  
  500.  
  501. ┌─────────────────────────────┐
  502. │ ExZip run time parameters   │
  503. │ ExZTest run time parameters │
  504. │ ────────╒══════════════════════════════════╕
  505. │ Define e│ Virus checking                   │
  506. │ ────────│ Duplicate checking               │
  507. │ Quit ExZ│ File attr╔══════════════════════════════════════╗
  508. └─────────│ ─────────║ Compressed file type to process:     ║
  509.           │ Dispositi╚════════════════════┌─────────────────────────────┐
  510.           │ Disposition of virus infection│ This program automatically  │
  511.           │ ──────────────────────────────│ recognizes & handles files  │
  512.           │ ZIP comment insertion         │ in ZIP, ARC & PAK formats!  │
  513.           │ Compression programs          └─────────────────────────────┘
  514.           │ Compression formats to process   │
  515.           │ Run time options (switches)      │
  516.           │ Activity log file                │
  517.           │ ──────────────────────────────── │
  518.           │ Supporting files (text)          │
  519.           │ Supporting files (processing)    │
  520.           ╘══════════════════════════════════╛
  521.  
  522.  
  523.  
  524. Run time options and switches
  525. ──────────────────────────────────────────────────────────────────────────────
  526.  
  527.         Yes, this is the part you have been looking for!  So now that you are
  528. here, pay attention!  Let's take them one by one:
  529.  
  530.  
  531. ┌─────────────────────────────┐
  532. │ ExZip run time parameters   │
  533. │ ExZTest run time parameters │
  534. │ ────────╒══════════════════════════════════╕
  535. │ Define e│ Virus checking                   │
  536. │ ────────│ Duplicate checking               │
  537. │ Quit ExZ│ File attri┌[ Run time options ]─────────────────────────┐
  538. └─────────│ ──────────│                                             │
  539.           │ Dispositio│ ReZip secondary ZIPs (Zip in Zip)    : Yes  │
  540.           │ Dispositio│ Use PCBoard's color codes            : Yes  │
  541.           │ ──────────│ Acceptable age of files (0-999 days) : 275  │
  542.           │ ZIP commen│ Fail or Warn if old file is detected : Fail │
  543.           │ Compressio│ Beeps & bells                        : Yes  │
  544.           │ Compressio│ Word wrap file descriptions          : Yes  │
  545.           │ Run time o│ Add last revision date to description: Yes  │
  546.           │ Activity l│                                             │
  547.           │ ──────────└───────────────────┌─────────────────────────────────┐
  548.           │ Supporting files (text)       │    Space or Enter to toggle     │
  549.           │ Supporting files (processing) │   Arrow keys to change lines    │
  550.           ╘═══════════════════════════════│          ESC to exit            │
  551.                                           └─────────────────────────────────┘
  552.  
  553.  
  554.  
  555.  - ReZIP switch: this does NOT mean that all files will automatically be
  556.    re-ZIPped for you!  However, since ExZTest does most of the work during a
  557.    shelled process it has no immmediate knowledge of things done, such as
  558.    possible files which have been removed from the secondary ZIPs.  This
  559.    switch simply tells ExZTest to reeZIP the file IF items have been removed
  560.    from the primary ZIP or if secondary ZIPs were processed.  This will also
  561.    slow the process a great deal!  BUT..  without this option you cannot
  562.    remove files from secondary ZIPs.. :)
  563.  
  564.  - Use PCBoard's color codes simply adds the "@X" codes to the result files
  565.    when turned on.
  566.  
  567.  - Age of files is measured in days and can range up to 999 days.  Placing a
  568.    ZERO here will disable age checking.  Placing a number other than ZERO will
  569.    tell ExZTest to check for the most recent file in the ZIP being no older
  570.    than the number of days you specify.  If all files are older than specified
  571.    here, the next item comes into play.
  572.  
  573.  - When a file is found "too old" for your system ExZTest can either warn the
  574.    user and allow the offending file anyway or it can fail the file and tell
  575.    the uploader why.  Your choice which..
  576.  
  577.  - Beeps and bells are sounds made by ExZTest when a file passes or fails.
  578.  
  579.  - Word wrap..  This one depends exclusively on the interface between your
  580.    PCBoard 14.5 system and ExZTest.  IF a caller is on-line, ExZTest will
  581.    fetch information from PCBoard, including the file description given by the
  582.    uploader and attempt to re-wrap it within PCBoard guide lines for you.
  583.  
  584.  - The last revision date switch has three toggle positions. If not running a
  585.    PCBoard 14.5 system you need to turn this OFF.  If you are, ExZTest can
  586.    pick out the most recent date within the new file and add it to your file
  587.    description for you, on the fly!  You may select this information to be
  588.    added with full word wrap (see previous switch) or to a seperate line by
  589.    itself.
  590.  
  591.  
  592.  
  593. Telling you about the results
  594. ──────────────────────────────────────────────────────────────────────────────
  595.  
  596.         ExZTest will keep a running log of what it has found for you.  This is
  597. a small feature which will see significant expansion in the future but we
  598. lected to get version 2 out (finally) so for now this remains rather skimpy.
  599.  
  600.  
  601. ┌─────────────────────────────┐
  602. │ ExZip run time parameters   │
  603. │ ExZTest run time parameters │
  604. │ ────────╒══════════════════════════════════╕
  605. │ Define e│ Virus checking                   │
  606. │ ────────│ Duplicate checking               │
  607. │ Quit ExZ│ File attribute handling          │
  608. └─────────│ ──────────────────────────────── │
  609.           │ Disposition of damaged files     │
  610.           │ Disposition of virus infections  │
  611.           │ ──────────────────────────────── │
  612.          ┌[ Activity log file ]───────────────────────────────────────┐
  613.          │                                                            │
  614.          │ Log file to use:                                           │
  615.          │         J:\PCB\EXZTEST.LOG                                 │
  616.          │                                                            │
  617.          └────────────────────────────────────────────────────────────┘
  618.           │ Supporting files (text)          │
  619.           │ Supporting files (processing)    │
  620.           ╘══════════════════════════════════╛
  621.  
  622.  
  623.  
  624. Defining your ExZTest supporting files - Part 1
  625. ──────────────────────────────────────────────────────────────────────────────
  626.  
  627.         There are TWO sets of supporting files used by ExZTest!  The first
  628. group consists of 4 files used for messages and information displayed to your
  629. caller.  These files will be looked for in your current directory when ExZTest
  630. is running.  If not found, your DOS search path will be checked, path by path,
  631. AS LONG AS YOU DO NOT specify a path during your setup!  Please note that when
  632. running on a PCBoard system the file extension is important!  You can create
  633. ALL of these files in various language versions with the proper extensions!
  634.  
  635.         The first of these files, EXZTEXT, contains the standard text lines
  636. used by the program.  This is NOT an ASCII text file!  Do not use a text
  637. editor to modify it!  Use ExZSetup's internal editor ONLY!  This is the only
  638. REQUIRED file of the four!!
  639.  
  640.         You may, room permitting, use any PCBoard color code, display variable
  641. and control character in these files, including nested file specifications!
  642.  
  643.  
  644. ┌─────────────────────────────┐
  645. │ ExZip run time parameters   │
  646. │ ExZTest run time parameters │
  647. │ ────────╒══════════════════════════════════╕
  648. │ Define e│ Virus checking                   │
  649. │ ────────│ Duplicate checking               │
  650. │ Quit ExZ│ File attribute handling          │
  651. └─────────│ ──────────────────────────────── │
  652.       ┌[ Supporting file specification ]─────────────────────────────────────┐
  653.       │                                                                      │
  654.       │ Files containing display text for errors & prompts:                  │
  655.       │   ExZTest standard text   : EXZTEXT                                  │
  656.       │   Text if file is too old : EXZDATE                                  │
  657.       │   Text if full duplicate  : EXZFDUP                                  │
  658.       │   Text if part duplicate  : EXZPDUP                                  │
  659.       │                                                                      │
  660.       └────────────────────────────── F2=Edit ───────────────────────────────┘
  661.           │ Supporting files (text)          │
  662.           │ Supporting files (processing)    │
  663.           ╘══════════════════════════════════╛
  664.  
  665.  
  666.         The files EXZDATE, EXZFDUP and EXZPDUP should contain text you wish to
  667. display to your caller if the file is either too old for your system, is a
  668. full, 100% duplication or a partial duplication respectively.  These are
  669. standard ASCII text files and may be created/edited with any text editor. You
  670. can use ExZSetup's primary menu to define the name of this text editor if you
  671. wish to use F2 interactively for them.
  672.  
  673.         If any of these 3 files is not found ExZTest will use the proper text
  674. from the EXZTEXT file t explain the problem.  If the needed file exists,
  675. ExZTest will append the file, in entirety, to the generated result file.
  676.  
  677.  
  678. ┌─────────────────────────────┐
  679. │ ExZip run time parameters   │
  680. │ ExZTest run time parameters │
  681. │ ─────────────────────────── │
  682. │ Define external text editor │
  683. │ ─────────────────────────── │
  684. │ Quit ExZSetup               │
  685. └─────────────────────────────┘
  686.                      ┌[ Text Editor ]────────────┐
  687.                      │                           │
  688.                      │ QEdit #                   │
  689.                      │          ┌────────────────────────────────────┐
  690.                      └──────────│   Enter a single pound sign (#)    │
  691.                                 │   where the file name should be.   │
  692.                                 │  This is a full DOS command line   │
  693.                                 └────────────────────────────────────┘
  694.  
  695.  
  696.  
  697.         When you select EXZTEXT and press F2 you will proceed to the internal
  698. editor where you will always see the intended text along with the text you may
  699. have changed to.
  700.  
  701.  
  702. ┌─────────────────────────────┐
  703. │ ExZip run time parameters   │
  704. │ ExZTest run time parameters │
  705. │ ────────╒══════════════════════════════════╕
  706. │ Define e│ Virus checking                   │
  707. │ ────────│ Duplicate checking               │
  708. │ Quit ExZ│ File attribute handling          │
  709. └─────────│ ──────────────────────────────── │
  710.       ┌[ Supporting file specification ]─────────────────────────────────────┐
  711.       │                                                                      │
  712.    ┌─[ EXZTEXT ]──────────────────────────────────────────────────────────  1 ┐
  713.    │                                                                          │
  714.    │ Default:                                                                 │
  715.    │      Unrecognized error occured.                                         │
  716.    ├──────────────────────────────────────────────────────────────────────────┤
  717.    │                                                                          │
  718.    │ Actual:                                                                  │
  719.    │      Unrecognized error occured.                                         │
  720.    └──────────────────────────────────────────────────────────────────────────┘
  721.           ╘══════════════════════════════════╛
  722.  
  723.  
  724.         NOTE!!  YOU MUST CREATE THIS FILE BEFORE USING EXZTEST!!
  725.  
  726.  
  727.  
  728. Defining your ExZTest supporting files - Part 2
  729. ──────────────────────────────────────────────────────────────────────────────
  730.  
  731.         There are three additional supporting files, used for processing,
  732. which you may elect to use with ExZTest. Each of them are handled in the same
  733. fashion but they each have different uses.  In all cases you may use the
  734. question mark as a wild card character, however, you may NOT use an asterisc!
  735.  
  736.  
  737. ┌─────────────────────────────┐
  738. │ ExZip run time parameters   │
  739. │ ExZTest run time parameters │
  740. │ ────────╒══════════════════════════════════╕
  741. │ Define e│ Virus checking                   │
  742. │ ────────│ Duplicate checking               │
  743. │ Quit ExZ│ File attribute handling          │
  744. └─────────│ ──────────────────────────────── │
  745.          ┌[ Supporting files ]────────────────────────────────────────┐
  746.          │                                                            │
  747.          │ Unwanted files' list:                                      │
  748.          │         J:\PCB\NODE8\EXZIP.EXC                             │
  749.          │ Acceptable duplications' list:                             │
  750.          │         J:\PCB\NODE8\EXZIP.VDL                             │
  751.          │ 'Do Not Process' file list:                                │
  752.          │         J:\PCB\NODE8\EXZIP.DNP                             │
  753.          │                                                            │
  754.          └────────────────────────[ F2=Edit ]─────────────────────────┘
  755.           │ Supporting files (processing)    │
  756.           ╘══════════════════════════════════╛
  757.  
  758.  
  759.         The "unwanted" file listing contains names which you wish to delete
  760. from a ZIP file at all times.  Typically, you might add things such as
  761. COMMAND.COM or PKUNZIP.EXE (how could you extract PKUNZIP from a ZIP if you
  762. didn't already have it?).
  763.  
  764.         The "acceptable duplication" listing should not be used.  Use the
  765. ZDCS Allowed Duplicate feature.  
  766.  
  767.         The "do not process" listing tells ExZTest to completely bypass a 
  768. file listed here.  This is useful mostly for ExZip.
  769.  
  770.         To define either of these files you need to specify their actual
  771. location, including drive and path, along with the name of the file to use. If
  772. the file does not exist the name will flash in red.
  773.  
  774.         To create or edit these files highlight the one you wish to work on
  775. and press F2.
  776.  
  777. ┌─────────────────────────────┐
  778. │ ExZip run time parameters   │            ┌[ Pick list ]────────────────┐
  779. │ ExZTest run time parameters │            │ WELCOME.TXT    READ_ME.PLS  │
  780. │ ────────╒════════════════════════════════│ VIRUSCHK.DOC   READ_ME.750  │
  781. │ Define e│ Virus checking                 │ U_README       READ_1ST.PLS │
  782. │ ────────│ Duplicate checking             │ U_READ.ME      READ_1ST.EXE │
  783. │ Quit ExZ│ File attribute handling        │ U_CAN.REG      READTHIS.TOO │
  784. └─────────│ ───────────────────────────────│ UREAD1ST       READNOW.TFB  │
  785.          ┌[ Supporting files ]─────────────│ UGLY.COM       README2.COM  │
  786.          │                                 │ U-CAN.REG      README1.DOC  │
  787.          │ Unwanted files' list:           │ TYPE.ME        README.TFB   │
  788.          │         J:\PCB\NODE8\EXZIP.EXC  │ TPB            README.ROS   │
  789.          │ Acceptable duplications' list:  │ SOUND.MSG      README.CUE   │
  790.          │         J:\PCB\NODE8\EXZIP.VDL  │ SAVEADS.ZIP    README.??    │
  791.          │ 'Do Not Process' file list:     │ SAFE_OWL.COM   README.33    │
  792.          │         J:\PCB\NODE8\EXZIP.DNP  │ RUN-ME.COM     README-9.??? │
  793.          │                                 │ ROSEREAD.ME    README-8.??? │
  794.          └────────────────────────[ F2=Edit│ ROCKLAND.BBS   README-7.??? │
  795.           │ Supporting files (processing)  │ READ_ME.TXT    README-6.??? │
  796.           ╘════════════════════════════════├─────────────────────────────┤
  797.                                            │ Scratch pad  : WELCOME.TXT  │
  798.                                            └─────────────────────────────┘
  799.  
  800.  
  801.         The 'pick list' displayed may contain no files or more files than will
  802. fit in the display window (depending on your file).  You can move around this
  803. list with your arrow keys easily.  To change an existing entry simply
  804. highlight it and press the ENTER key.  The name will move down to the "scratch
  805. pad" for editing.  To add a new name to the list press INS.  This will make
  806. "room" for a new item.  To remove a name from the list highlight the item to
  807. be removed and press DEL.  Remember that the list of names will always be
  808. resorted for you on exit.
  809.  
  810.  
  811.  
  812. Finishing it all up..
  813. ──────────────────────────────────────────────────────────────────────────────
  814.  
  815.         If you entered correct information and selected the proper options you
  816. wish to use you are now ready for a test run of ExZTest!
  817.  
  818.  ┌─────────────────────────────┐
  819.  │ ExZip run time parameters   │
  820.  │ ExZTest run time parameters │
  821.  │ ────────╒══════════════════════════════════╕
  822.  │ Quit ExZ│ Virus checking                   │
  823.  └─────────│ Duplicate checking               │
  824.            │ File attribute handling          │
  825.            │ ──────────────────────────────── │
  826.            │ Disposition of damaged files     │
  827.            │ Disposition of virus infections  │
  828.            │ ──────────────────────────────── │
  829.            │ ZIP comment insertion            │
  830.            │ Compression programs             │
  831.            │ Process files in .ARC format     │
  832.            │ Use ANSI ┌──────────────────────────────────────┐
  833.            │ Activity │ Save changed information (if any)? _ │
  834.            │ ─────────└──────────────────────────────────────┘
  835.            │ Paths to process                 │
  836.            │ Supporting files                 │
  837.            │ Index file specifications        │
  838.            ╘══════════════════════════════════╛
  839.  
  840.  
  841. Press ESC one more time to leave the setup program:
  842.  
  843.  
  844. So long from ExZSetup v2.1 and remember...
  845.     Smoking is one of the leading causes of statistics.                         
  846.                                                                                 
  847.  
  848.  
  849.  
  850. Command line options
  851. ──────────────────────────────────────────────────────────────────────────────
  852.  
  853.         There are relatively few command line options available in ExZTest.
  854. All are identified by a leading / (slash) as the first character of the option.
  855. Options are not case sensitive, may be specified in any order and leading and
  856. trailing spaces are ignored.  All of them may be abbreviated down to 2
  857. characters (except specified values where applicable).
  858.  
  859. The ExZTest command line is:
  860.  
  861.         EXZTEST <filespec> <mode> </option1> </option2> ... </option?>
  862.  
  863. To use this in your PCBTEST.BAT file you need to replace filespec with %1 and
  864. mode with %2.  PCBoard will do the rest for you!  Thus, your batch file will
  865. likely look as complicated as this one here:
  866.  
  867.         @Echo off
  868.         Exztest %1 %2
  869.  
  870. Whew!  Glad that one is behind us!  :)  To use ExZTest manually for testing
  871. individual files you need to know what those optional items are.
  872.  
  873.         <filespec> is the full drive, path and name (including extension) of
  874.                    the file you wish to test.
  875.  
  876.         <mode>     must be the keyword "UPLOAD" or "TEST" without the quotes.
  877.                    When using the keyword UPLOAD, ExZTest will perform all
  878.                    functions you specified in your configuration file.  When
  879.                    using the keyword TEST it will do only limited tests, those
  880.                    which will NOT alter the file, in order to establish file
  881.                    integrity.
  882.  
  883.         All options MUST follow the two above parameters.  None of them need
  884. to be present.  All command line options may be abbreviated to the first two
  885. letters following the slash (and must be at least that long).  The available
  886. options and their uses are:
  887.  
  888.         /C=     Optional configuration file specification.  If this is
  889.                 present, it will override the program's default name of
  890.                 EXZTEST.CFG.  If the file name is not preceeded by a drive
  891.                 and/or path specification ExZTest will search all paths
  892.                 specified in your DOS PATH= setting in order to locate the
  893.                 file.  The equal sign IS REQUIRED.
  894.  
  895.         /T=     Optional work drive letter.  ExZTest defaults to using the
  896.                 current drive for work areas.  This can be slow on a network
  897.                 system and if sufficient memory is available you can direct
  898.                 ExZTest to use a RAM drive or another network drive perhaps.
  899.                 Bear in mind that when testing a large file ExZTest WILL NEED
  900.                 space!  More space than the file requires if re-Zipping!  If
  901.                 you are pointing ExZTest to a RAM drive it MAY run out of
  902.                 space which is a condition it cannot help!  But, it will
  903.                 handle all work paths in a network compatible manner.
  904.  
  905.         /KE     If you wish to see what ExZTest is doing you can use this
  906.                 parameter to have it leave the work BAT files on-line for you.
  907.                 This has no practical value beyond troubleshooting and
  908.                 learning.
  909.  
  910.  
  911.  
  912. Other options, notes & thoughts
  913. ──────────────────────────────────────────────────────────────────────────────
  914.  
  915.  
  916.      EXZUTIL.COM  - this is a small program which you can place in any of
  917.                     your search paths.  ExZTest cannot determine if a file
  918.                     with the .EXE extention (contained within a ZIP) is a
  919.                     self-extracting archive or not.  It will look for the
  920.                     presence of ExZUtil and if it finds it, it will use the
  921.                     program to identify self-extracting ZIP files with the EXE
  922.                     extension.
  923.  
  924.      ZIPs in ZIPs - ExZTest will fully process a ZIP found within a ZIP (or for
  925.                     that matter an ARC in a ZIP or ARC in an ARC).  However,
  926.                     it will NOT process down to the third level.  Inasmuch as
  927.                     I find ZIPs in ZIPs an acceptable practice I disagree with
  928.                     going to 3 or more levels.
  929.  
  930.      Problems     - All known problems of previous release versions have been
  931.                     corrected.
  932.  
  933.      ZDCS         - Duplicate checking depends a great deal on your ability to
  934.                     initially set-up the software.  This package is supplied
  935.                     with full documentation and startup instructions.  Please
  936.                     use it!
  937.  
  938.                     Once you have 'cleaned up' your system and eliminated
  939.                     duplications which already existed (if that is desired)
  940.                     you can, if you want to also eliminate multiple occurances
  941.                     of signatures.  Again, ExZTest looks only for identical
  942.                     matches.  Please see individual program instructions for
  943.                     the one you decide to use for more details.
  944.  
  945.                     ZDCS versions prior to 2.0 will NOT work!  You need to
  946.                     interface with the 2.0 or later release!!
  947.  
  948.      Memory use   - ExZTest uses a substantial amount of RAM which is 
  949.                     allocated dynamically as needed.  Since the supporting 
  950.                     files, such as ExZTest.EXC are loaded in entirety the 
  951.                     amount of memory required will vary from site to site.  
  952.                     You must remember, however, that ExZTest will shell and 
  953.                     load programs such as PKZIP which require a fair amount 
  954.                     of RAM by themselves (I have seen PKZIP use as much as 
  955.                     300+ KB) thus the more memory you can give it the safer 
  956.                     you'll be.  I cannot check for memory while in a DOS 
  957.                     shell!  ExZTest will insist that you use the PCBoard 
  958.                     "/SWAP" parameter when low memory is detected at 
  959.                     startup!
  960.  
  961.      Disk use     - ExZTest unzips files it processes one at a time, thus the
  962.                     space required for work areas will not be greater than the
  963.                     contents of the largest ZIP it is to process.
  964.  
  965.  
  966.  
  967. The end  (yes!  really!)
  968. ──────────────────────────────────────────────────────────────────────────────
  969.  
  970.         I really do not have much more to add although I am quite certain I
  971. have overlooked a number of points which perhaps should have been mentioned. 
  972. I never claimed to be good at writing documentation.  :)  If ExZTest works 
  973. for you and helps that is great.  If I wasted your time reading all this 
  974. and it really isn't for you, so be it.
  975.  
  976.         Please note that any trade marks and service marks mentioned in this
  977. document belong to someone.  I do not hold any trademarks on anything
  978. associated with this software.  I do, however, reserve all rights and
  979. copyright to ExZTest, ExZSetup and ExZip.
  980.  
  981.         My greatful appreciation to many who have helped ExZTest get to 
  982. where it is today including but not limited to the beta testers whose files 
  983. and directories were at the mercy of early versions.  Although all beta 
  984. tester feedback is valuable I need to specifically thank Mike Meyer and 
  985. Ray Novino for their time and dedication to this project and Mark Rapp for 
  986. expanding on some of the original ideas.  
  987.  
  988.         All typos (for which I am famous) found in this document are
  989. intentional.  (And if you beleive that you should send me $1,000 in small
  990. bills for registration!)
  991.  
  992.         All items which have been forgotten will eventually be removed from
  993. the program to make it consistent with the documentation.
  994.  
  995.         Since, in my opinion, no documentation should ever exceed 1000 lines
  996. in length (and if so, it should certainly not be by much) we'll put an end to
  997. this real soon.  If you managed to read this far you should bear in mind that
  998. you might be the only one!  If you need to contact me I can be reached on 
  999. the ILink mail network ZDCS-Support conference, the Intelec mail network 
  1000. ZDCS-Support conference, or the Salt Air BBS ZDCS-Support conference.  I can
  1001. also be reached on The Hacker Central BBS.  201-334-2555  2400 8N1 
  1002.  
  1003.         Have fun!
  1004.  
  1005.  
  1006.